2 Discovering and Monitoring Targets

2.1.1 What is Discovery?

Discovery refers to the process of identifying unmanaged hosts and targets in your environment. You can discover hosts and targets automatically or manually.

Figure 2-1 illustrates the discovery process.

Figure 2-1 Discovery

For further information on how to discover unmanaged hosts refer to Step 1: Discovering Unmanaged Hosts Using Network Scan.

For further information on how to discover targets on managed hosts refer to Step 3: Discovering Targets on Managed Hosts

2.1.2 What is Promotion?

Promotion refers to the process of converting unmanaged hosts and targets to managed hosts so that they can be monitored in Enterprise Manager Cloud Control. Promotion involves installation or deployment of a Management Agent on the host, only if you are promoting host targets.

Figure 2-2 illustrates the promotion process.

Figure 2-2 Promotion

2.1.3 What is Monitoring?

Monitoring refers to the process of gathering information and keeping track of activity, status, performance, and health of targets managed by Enterprise Manager Cloud Control on your host. A Management Agent deployed on the host in conjunction with plug-ins monitors every target in your environment.

2.4.1 Prerequisites

• To run automatic host discovery (Nmap binary) on a Management Agent installed on a Solaris system, follow these steps:

  1. Install GCC 3.4.3 or higher on the Solaris system.

  2. Stop the Management Agent from the running.

  3. Execute the following commands on the terminal session which you will use to start the Management Agent:

     bash-2.03$ LD_LIBRARY_PATH=<directory path of gcc libraries>:$LD_LIBRARY_PATH

     bash-2.03$ export LD_LIBRARY_PATH

     Note:

     These steps ensure that Nmap refers to the GCC libraries while the Management Agent is running.

  4. Start the Management Agent using the terminal session used for the previous step.

  Note:

  Add LD_LIBRARY_PATH to your start up scripts so that this setting is retained after you reboot your system.

• To discover hosts from a Management Agent running on the following systems, follow the prerequisites stated in Table 2-1.

  Table 2-1 Prerequisites for discovering hosts

  System	Prerequisites
  Solaris 11 cluster (SPARC or x86-64)	Create a static IPv4 address on interface net0: ipadm create-addr -T static -a local=X.X.X.X/YY net0/ZZ Here, X.X.X.X is a static IPv4 address, YY is the sub network mask, and ZZ is the specific identity for the net0 interface. The created static address will subsequently be identified by net0/ZZ. For example: ipadm create-addr -T static -a local=10.134.108.101/24 net0/hh
  SUSE Linux for System z™	Run the QETH_OPTIONS='fake_ll=1' option by adding it to the configuration file for the NIC present in the /etc/sysconfig/hardware directory. The name of the configuration file changes according to the NIC used. Contact your system administration for the name of the configuration file that your system uses. Restart your system for the changes to take effect.
  RedHat Linux for System z	Run the OPTIONS='fake_ll=1' option by adding it to the configuration file for the NIC present in the /etc/sysconfig/network-scripts directory. The name of the configuration file changes according to the NIC used. Contact your system administration for the name of the configuration file that your system uses. Verify that the alias in the /etc/modprobe.conf file includes the following command: alias eth0 geth Restart the system for the changes to take effect.

  
  

2.4.2 Step 1: Discovering Unmanaged Hosts Using Network Scan

To discover and configure hosts using IP scan, follow these steps:

1. From the Setup menu, select Add Target, then select Configure Auto Discovery.

2. On the Configure Auto Discovery page, click the Configure icon against Host and Oracle VM Manager in the Network Scan-based Auto Discovery table.

   
   

3. On the Network Scan Discovery page, click Create. You will now create the discover job. By default, the Name field will be populated with a title including that date and time the job was created. Note that you can edit the discovery jobs and schedule discovery to run immediately or later.

   
   

4. On the Network Scan Discovery: Create page, click Add. You will now select the Management Agent that will perform the network scan. You can select the Management Agent that is installed by default on the Oracle Management Service host, or can select another Agent if desired.

   
   

   Note that because the entire network will be scanned, the Sudo Privilege Delegation must be set on the Management Agent host that will perform the scan.

5. Select the agent in the IP Ranges for scan table, and enter the IP ranges to scan. You can specify any or even all of the following:

   • One or more absolute hostnames, each separated by a space; for example: host1.example.com host3.example.com

   • One or more IP addresses, each separated by a space

   • A range of addresses; for example: 10.0.0-255.1-250. Note that IP addresses and IP ranges must be separated by a comma; for example: 10.0.0-255.1-250

   • Classless Inter-Domain Routing (CIDR) notations; for example: 128.16.10.0/24

   Separate each value with a space; for example:

   host1.example.com 192.168.0.1 128.16.10.0/24 10.0.0-255.1-250,254

6. A default list of ports to scan within the IP ranges you specified is listed in the Configure Ports table. These are default ports typically used by the listed Oracle components.

   To modify the port values for a component, select the component in the table and change the values accordingly. Up to 10 ports and/or port ranges can be specified.

7. If you want to add more component ports to the list, click Add. Enter the name of the service to include, and specify the port(s) or port range to scan.

8. Specify the following:

   • The schedule at which the discovery job will run. Note that you can start the job immediately.

   • The credentials set on the Management Agent that will perform the scan.

     As noted, the Sudo Privilege Delegation must be set on the Management Agent host that will perform the scan. The named credential that will be used must be configured to run as root.

   Click Save and Submit Scan.

9. After the discovery job executes, you can check for discovered hosts that may contain potential targets. You can do this two ways:

   • Select the job in the Host Discovery page, then click View Discovered Targets;

     or:

   • From the Setup menu, select Add Target, then select Auto Discovery Results.

2.4.3 Step 2: Converting Unmanaged Hosts to Managed Hosts

To convert unmanaged hosts to managed hosts, follow these steps:

1. From the Setup menu, select Add Target, and then select Auto Discovery Results.

2. On the Auto Discovery Results page, select the Network-scanned Targets tab. All discovered hosts are listed, with the open ports and identifiable service names shown. Based on your understanding of the Oracle components deployed on your network, you should be able to determine the types of potential targets that have been discovered.

3. Select a host from the table, then click Promote to promote the host to managed target status. The Add Host Targets wizard opens. You will use this wizard to install a Management Agent on the host.

   
   

   Installing a Management Agent on an unmanaged host promotes the unmanaged host to managed target status, thereby converting the host to a managed host.

2.4.4 Step 3: Discovering Targets on Managed Hosts

To discover targets on managed hosts, follow these steps:

1. From the Setup menu, select Add Target, and then select Configure Auto Discovery.

2. On the Configure Auto Discovery page, click the Configure icon in the All Discovery Modules row in the Configure Auto Discovery table.

   
   

3. On the Target Discovery (Agent-based) page, expand Search, then enter the hostname for the host you want to check for targets in the Agent Host Name field. The host must have a Management Agent installed on it.

4. To search for a specific Management Agent, click Search. The table lists all the Management Agents and filters the list based on what you search for.

5. Select the host in the table and click Configure Discovery Modules.

   
   

6. On the Configure Target Discovery page, set the schedule at which discovery will be run, in days. This schedule will be applied to all selected hosts. By default the discovery will run every 24 hours.

7. Select the target types you want to discover on the host. Note that you must supply search parameters for some target types. To specify a parameter, select the target type in the Discovery Module column and click Edit Parameters.

   • Oracle Cluster and High Availability Service: No parameters required.

   • Oracle Database, Listener and Automatic Storage Management: Specify the path to the Clusterware Home.

   • Oracle Home Discovery: No parameters required.

   • Oracle Secure Backup Domain: No parameters required.

   • Oracle Fusion Middleware: Specify * (the "star" character) to search all Middleware Homes, or specify the path to one or more Middleware Homes on the host, each separated by a comma.

8. Click OK when finished. Target discovery has been configured on this host.

9. Repeat these steps for each additional host on which you want to configure discovery.

10. Click Run Discovery Now to discover targets immediately. The discovery will also run at the scheduled interval.

2.4.5 Step 4: Promoting Targets

To promote discovered targets to managed status, follow these steps:

1. After the discovery job executes, you can check for discovered hosts that may contain potential targets. You can do this two ways:

   • Select the job in the Host Discovery page, then click View Discovered Targets; or

   • From the Setup menu, select Add Target, then select Auto Discovery Results.

2. Select a target to promote, then click Promote. A wizard specific to the target type you are promoting opens. Supply the required values.

   
   

3. Click the Agent-based Targets tab.You can choose one or several targets to promote.

4. Note that you can optionally click Ignore for a discovered target. Ignoring a target puts it into a list of targets that you do not want to manage.

   Ignored targets will be displayed in the Ignored Targets tab, and will remain in Cloud Control as un-managed targets until you decide to either promote or remove them. If you delete a target, it would be rediscovered the next time discovery runs.

5. Check the target type home page to verify that the target is promoted as an Enterprise Manager target. Once a target is successfully promoted, the Management Agent installed on the target host will begin collecting metric data on the target.

2.5.1 Add Host Targets

To convert unmanaged hosts to managed hosts manually, you should manually install a Management Agent on each host. You can install a Management Agent on a managed host by using:

• Add Host Wizard

  To convert an unmanaged host to a managed host, follow these steps:

  1. From the Setup menu, select Add Target, then select Add Targets manually. Enterprise Manager Cloud Control displays the Add Targets Manually page.

  2. Under the Add Targets Manually page, go to the Add Targets Manually subsection and choose Add Host Targets. Click Add Host...

     A wizard guides you through the process of manually deploying a Management Agent to a new host target.

• Silent Method

  For instructions on installing a Management Agent using silent method, see "Installing Oracle Management Agent" in the Enterprise Manager Cloud Control Basic Installation Guide.

2.5.2 Add Targets Using Guided Process

To add targets manually to a specific Management Agent for monitoring, using a guided process, follow these steps:

1. From the Setup menu, select Add Target, then select Add Targets Manually. Enterprise Manager Cloud Control displays the Add Targets Manually page.

2. On the Add Targets Manually page, select Add Targets Using Guided Process (Also Adds Related Targets).

3. Choose one of the target types to add from the Target Types list, such as Exalogic Elastic Cloud, Oracle Cluster and High Availability Service, or Oracle WebLogic Domain. Click Add Using Guided Process...

   
   

4. After you select the target type, a wizard specific to the target type guides you through the process of manually adding the target.

   Upon confirmation, the target becomes a managed target in Enterprise Manager Cloud Control. Cloud Control simply accepts the information, performs validation of the supplied data where possible and starts monitoring the target.

2.5.3 Add Targets Declaratively by Specifying Target Monitoring Properties

To manually add a target on a managed host, follow these steps:

1. From the Setup menu, select Add Target, then select Add Targets Manually. Enterprise Manager Cloud Control displays the Add Targets Manually page.

2. On the Add Targets Manually page, select Add Targets Declaratively by Specifying Target Monitoring Properties.

   
   

3. Choose one of the target types to add from the Target Types list, such as ADF Business Components for Java, Cluster Database, or Oracle HTTP Server.

4. Specify the Management Agent that will be used to monitor the target, or click on the Search icon to search for and select the Management Agent. Click Add Manually...

5. After you select the target type, a wizard specific to the target type guides you through the process of manually adding the target.

   Upon confirmation, the target becomes a managed target in Enterprise Manager Cloud Control. Cloud Control simply accepts the information, performs validation of the supplied data where possible and starts monitoring the target.